home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / amigan / amigan 17 / fontrepair / fontrepair.doc < prev    next >
Encoding:
Text File  |  1994-01-27  |  5.1 KB  |  107 lines
  1.                           FONTREPAIR INSTRUCTIONS
  2.  
  3.     There are two known bugs in CALLIGRAPHER font editor version 1.0 and
  4.     these manifest in fonts created with it in some circumstances.
  5.  
  6.     The first bug is if a "NEW FONT" is created without using an exiting
  7.     font as the font template, then the fontname will be misaligned by one
  8.     byte. This will create a problem using Availfonts() in the operating
  9.     system failing to recognize the fontname and will load a new copy
  10.     everytime that font is called for by a program.  In the worst case,
  11.     PROWRITE calls Availfonts() every half-second and continually loads
  12.     copies of the font until all 10 megs of ram is filled, causing an
  13.     out-of-memory crash.
  14.  
  15.     THE CURE IS "FONTREPAIR"!!!  FontRepair includes directions within
  16.     itself, so even without these instructions you can always know how to
  17.     use it if you have it.  FontRepair works only from CLI. You use it by
  18.     typing FontRepair on a CLI line, followed by the fonts you want
  19.     repaired, in the following syntax:
  20.  
  21.          1> FontRepair -DFn:fonts
  22.                           ^
  23.                           |
  24.                           Where "n" = number of drive where the fonts
  25.                           directory is located.
  26.  
  27. ********************************************************************************
  28.  
  29.     (WARNING ON COMMAND ENTRY!! The instructions above are misleading!
  30.     (To see the set built into FontRepair itself, enter: 1> fontrepair in
  31.     CLI.) We re-directed those program instructions to ramdisk and copy
  32.     them below. They're not easy to follow. They assume (but don't say)
  33.     that FontRepair is in the C directory (or on Fonts disk) and that CD
  34.     is set to the Fonts disk.
  35.     --------------------------------------------------------------------
  36.           Font Repair by Edward Kilham
  37.          (c) Inter/Active Softworks 1987
  38.  
  39.        Usage: FontRepair [(-)files]
  40.        Example: FontRepair fonts/topaz fonts/ruby -colorfonts
  41.        fonts/topaz indicates a single font set to be fixed.
  42.        -colorfonts indicates a directory of font sets to be fixed.
  43.     ---------------------------------------------------------------------
  44.     Even these instructions are incomplete and dangerous. They say
  45.     nothing about CD or which disk the fonts are on. To see how robust
  46.     the program was if we made errors in the command line, we tried a
  47.     few variations with the commands (we wanted to fix a single face,
  48.     dropcaps 54). Commands improperly given will at best fail and at
  49.     worst crash you. Here's what happened with FontRepair in ramdisk:
  50.  
  51.      ram:fontrepair -df1:dropcaps       Fails to UNABLE TO CONTINUE READING
  52.      ram:fontrepair -df1:dropcaps/54           Ditto
  53.      ram:fontrepair -df1:fonts/dropcaps        GURU!
  54.      ram:fontrepair -df1:fonts/dropcaps/54     GURU!
  55.      ram:fontrepair -df1:fonts          Screens and fixes every font in FONTS.
  56.  
  57.     1. You must NOT use that prefixed dash to fix a single font in
  58.     a FONTS directory. Here's an example of a proper command, with
  59.     FontRepair in ramdisk and the font we want to fix (DROPCAPS) in a
  60.     font directory on drive 1:
  61.  
  62.             1> ram:fontrepair df1:fonts/dropcaps      [Works]
  63.  
  64.     2. If you do it the following way, the program fails or GURUs.
  65.  
  66.             1> ram:fontrepair -df2:fonts/dropcaps
  67.  
  68.     3. The prefixed dash is used ONLY when you want a whole directory
  69.     of fonts checked and fixed in one pass, as in:
  70.  
  71.             1> ram:fontrepair -df1:fonts  [screens and fixes ALL fonts
  72.                                            in the Fonts DIR of drive 1]
  73.  
  74.             1> ram:fontrepair -df1:colorfonts [screens and fixes all
  75.                                                fonts in DIR colorfonts]
  76.  
  77.     4. If the program works properly, it delivers a message: "Analyzing
  78.     SuchAndSo font". If that message doesn't appear and all you see on
  79.     screen is a copyright notice, the program failed. When you screen an
  80.     entire FONTS directory, the program will name each font it analyzes.
  81.     If it doesn't do that, it has failed.
  82.  
  83.     I hope this additional information helps others.
  84.  
  85.                                  Dick Barnes
  86.                                  Editor
  87.                                  Amigan Apprentice & Journeyman
  88.  
  89. ********************************************************************************
  90.  
  91.     FontRepair is PUBLIC DOMAIN and should be distributed as widely as
  92.     possible!
  93.  
  94.     The other bug known to Calligrapher publisher is: Conversion of fonts
  95.     from "Fixed Width" to "Proportional Width" is one way only and
  96.     permanent! A proportional width font will never act as a fixed width
  97.     font again! Fonts smaller than 32 point limit of FONTED on the 1.2
  98.     Extras disk can be loaded, toggle "fixed width" on, and save back to
  99.     disk.
  100.  
  101.     Both bugs are fixed in Calligrapher 1.05, which has passed testing.
  102.     There are significant improvements added to the new Callig 1.05 disk,
  103.     like a "FontMover" program which displays, fixes, repairs, and moves
  104.     fonts from one disk to another. All the separate utilities have been
  105.     combined in one program, especially useful to users of Workbench only,
  106.     with one disk drive and 512K of memory.
  107.